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1.0 Gener al 

DPT is the debugging systea for 
Tine-Sharing Systea. It has faciliti 
reference to and typeout of aeaory ce 
registers, Futheraore, it peraits the u 
the saae aanner as in the asseabler. It 
breakpoints into prograas, perfora a 
prograas for specified words and spec 
addresses. In addition, their is a pow 
breaking facility that will allow the user 
exact condition under which he wants the 
Finally, DDT can load both absolute and rel 
the foraat produced by the asseabler. 



the SDS g^O 
es for symbolic 
lis and central 
se of literals in 
can also insert 
trace, and search 
ified effective 
erful conditional 
to specify the 
program to break, 
ocatable files in 



The systea has a language for communication between DD* 
and its users. The basic coaponents of this language are 
syabols , constants , and coaaands* 



* synbol is any string of letters 
containing at least one letter. ffl 
followed by B or D and possibly anothe 
as an octal or decimal nuaber respect 
aore than sir characters, only t 
significant: thus, ALPHABET is egui 
opcodes recognized by the asseabler a 
except for soae I/O instructions, 
syabol with a special aeaning explaine 
There are also soae constructs li 
which under most circumstances act e 
See the section on special syabols. 



, diaits, and dots(.) 
owever, a digit strina 
r digit is intprpreted 
ively) . Tn symbols of 
he first six are 
▼alent to AlPPAR. All 
re built-in symbols. 
Dot f. ) is a built-in 
d in a later section, 
ke ;A (the A-register) 
xactly like symbols. 



Every syabol nay have a value. This value is a 24-bit 
integer; for most syabols it will be either an address in 
aeaory or the octal encoding of an operation code. 
Fxaaples: 

ABC 

AB12& 

12TY2 

The following are not syabols: 

13SB 

AB«CD 



Syabols aay be introduced to 
different ways: 



DDT in two basically 



(A) They aay be written out by the asseabler and read 
in froa the binary file by DDT. 
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(B) They nay be typed in and assigned values flaring 
debugging. 

It is possible for a symbol to be undefined. This may 
occur if a program is loaded which references an external 
symbol not defined in a previously loaded program. It may 
also occur if an undefined symbol is typed in an expression. 
Tn general , undefined symbols are legal input to DDT exceDt 
when their values would be reguired immediately for the 
executuion of a command. Thus, for example, the ;G (GO TO) 
command would give an error if its argument is an undefined 
symbol. 

Undefined symbols may become defined in several ways. 
They may be defined as external in the assembler (i.e., with 
FXT, or t) and read by DDT as part of a binary program. 
Alternatively, they may be defined by one of *he symbol 
defintion commands available in DDT. When the definition 
occurs, the value of the symbol will be substituted in all 
the expressions in which the symbol has appeared. 

Tf DDT types [U] after typing out the contents of a 
cell symbolically, it means that the cell contains an 
undefined symbol. The cell is closed at once so that its 
contents cannot be erroneously changed. 

The only restriction on this facility is that, as for 
NARP, the undefined symbol must be the only thing in the 
address field of the word in which it appears. Tncorrect 
uses of undefined symbols will be detected by DD^ and will 
result in the error comment (0) . 

DDT keeps track o^ references to undefined symbols by 
building pointer chains through the address fields of the 
words referring to the svmbol. *or each umdefined symbol, 
DDT will construct a different pointer chain for each 2K 
page in the users map which contains a reference to the 
symbol. The pointers to the beginnings of these chains are 
maintained in a 2K page acquired by DDT and not accessable 
by the user. A chain pointer is stored in the rioht eleven 
bits of the address field. Bit 10 marks the end of a chain 
and bit 11 indicates whether the symbol should be patched up 
on 1ft bits or 2ft bits when the symbol is defined. 

From this description is should be obvious what will 
happen if the pointer chain is iestroyed. A probable 
consequence is that a search down the pointer chain will not 
terminate. DDT will often do such searches whenever it 
prints an address. If the chain it is searching has more 
than ?S6 links, it will print the symbol followed by (n) and 
continue. A chain may be destroyed by clobbering a word in 
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the chain or by removing a page containing undef ined 
references from the user map. A word of warning, DDT 1 *; 
loader nay become confused or go into a loop if a binary 
program is loaded which attempts to define an undefined 
symbol whose reference chains are not all in the map. 
Pixing up an undefined symbol pointer chain which has been 
clobbered is an exercise which we leave to the reader. 

1.2 *lock Structur e 

A limited facility called the block structure facility 
is provided to simplify the referencing of local symbols 
which are defined in more than one separately loaded 
program. Wote that DDT^s block structure has only a tenuous 
connection with the block structure of ALGOL. The block 
structure of a program is organized in the following manner: 
every IDENT read by DDT as part of a binary file begins a 
new block. Any local symbol known to DDT has a block number 
associated with it; global symbols do not have a block 
number, nndefined symbols are always treated as global. 

The name of a block is the symbol in the label field 
of the IDENT. If two IDENTs with the same symbol are read r 
the message (ALREADY LOADED) is printed, and the local 
symbol tables for the two TDENTs will be merged. 
Conflicting symbol definitions will be overwritten. 

Tf local symbols are defined in a binary program file, 
with no preceeding IDENT, then DDT will assign an IDENT name 
such as 03X. Global symbols must be unigue within an entire 
program amd are recognized at all times. Tf a multiple 
definition is encountered, the latest one takes precedence. 
Local symbols are recognized according to the following 
rules: 

(1) At any given time one block is called the primary 

block. All local symbols associated with the 
primary block will be recognized. 

(2) Tf a symbol is used which is neither global nor in 

the primary block, the entrire table is scanned 
for it. If it occurs in only one block, the 
symbol is recognized properly. Tf it occurs in 
more than one block, the error message (A) is 
printed. 

O) A symbol may be explicitly qualified by writing: 
STMACSTHB. SYHA must be the name of a block. 
SYHB is then referenced as though the block whose 
name is SYHA were primary. 
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(4) When a cell is opened (see section 2. 1) , the block 
to which the symbolic part of its location belongs 
becoaes primary. Thus, NHRXYZ/ causes block NN to 
become primary; if ABC is a unique local symbol in 
block PQ, then ABC/ causes PQ to become primay. 

1,3 literal s 

literals have the same format and meaning in DD* as in 
the assembler, i.e., the two characters • =• signal the 
beginning of a literal, which is terminated by any of the 
characters which ordinarly terminate an expression. Tn 
contrast to the assembler, the expression in a DDT literal 
nust be defined. 

The literal is looked up in the literal table. Tf it 
is found, the address which has been assigned to it is the 
value of the symbol. Tf it does not appear in the literal 
table, it is stored at the address which is the current 
value of the "special symbol" ;F, and this address is taken 
as the value of the literal. ;F is increased by 1. ^or 
example, if the literal -1 does not already exist in the 
literal table and ;F is 1000B, then typing LDA =-1 causes -1 
to be stored at 1000B, and is equivalent to LDA 1000*; the 
new value of ;F is 10001B- Exception: Tn patch mode (see 
section 2.8), literals are saved and not stored until the 
patch is completed since otherwise they would interfere with 
the patch. 

then DDT types out a symbol whose value is an address 
in the literal table, it will type it out in the same format 
in which it would be input; that is, as = followed by the 
numeric value of the literal. Tt should be noted that 
addresses specified as literals in a binary program file 
loaded by DDT will be printed as literals, however no entry 
into DDT's literal table is made for these addresses. 

1.q Consta nts 

A constant is any string of digits, possibly followed 
by a B or D , in turn possibly followed by another *igit. 
The number represented by the string is evaluated, truncated 
to 24 bits and then used just like the value of the a 
symbol. The radix for numbers is normally B (octal), but 
may be changed arbitrarily by the commands described in 
Section 2.4 below. If a number is terminated by B or n, it 
is interpreted as octal or decimal respectively regardless 
of the current radix. A digit following a B or ^ is 
interpreted as a power of B or 10 respectively by which the 
number is to be multiplied. Thus 1750B=17Sb1=1000d= 1dl. 
Constants are always printed by DO'** in the current ra<Hx. 
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1,5 Commands 

* command is an order typed to DDT which instructs it 
to do something. The com sands are listed and their 
functions explained in Section 2 below. 

" 1.6 Expression s 



An expression is 
connected by any of 
operators have the following significance 



a string of n ambers or symbols 
a large number of operators. These 



addition 

subtraction 

(integer) multiplication 

(integer) division 

logical AND 

less than 

equal to 

greater than 

logical OH 

x;+y means x;*3+y 

x;-y means x;*l-y 

remainder on (integer) division 

logical exclusive 0"R 



Expressions are evaluated strictly 
operators have the same precedence 
allowed. The first symbol or number m 
minus sign. Blank acts like pi 
subsequent operands are truncated to 1 
operated on the accumulated value of 
allows one to compute a value which is 
address field of an instruction. The 
is a 2ft bit integer. An expression ma 
or constant. The value of an express 
operation is either 1 or 
respectively. 

Examples: IDA 
LDA 



if the rela 



10 



has the 
has the 



left to right. All 

Parentheses are not 

ay be preceded by a 

us, except that all 

ft bits before being 

the expression. This 

loaded only into the 

value of an expression 

y be a single symbol 

ion after a relational 

tion is true or false 

value 7600000 
value 7600010 
if the radix is octal 



LDA 10D has the value 7600012 

If SYH is a symbol iwth the value 1212, then 

SY* has the value 1212 

SYW 10 has the value 1222 

LDA STH has the value 07601212 



Tf this last expression were put into a cell and later 
executed by the program the effect would be to load the 
contents of SYN, register 1212, into the A register. 
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When DDT types out expressions, two node switches 
control the format of the output. Commands for setting 
these nodes are described in Section 2.4 below. The word 
printout node determines whether quantities will be printed 
as constants or as symbolic expressions. In the latter 
case, the opcode (if any) and the address will be put into 
syabolic form. If the first nine bits of the value are all 
zeros or all ones, no opcode will be printed; in the latter 
case a negative integer will be printed. If the opcode is 
not recognizable as a synbol, it will be typed as a number 
followed by 'B5*. 

The address printout node controls the format in which 
addresses are typed. DOT types addresses when asked to open 
the previous or the next cell, when it reports the results 
of word and address searches, and on breakpoints. Tn 
relative mode, addresses are typed in symbolic form, i.e., 
as the largest defined symbol smaller than the address plus 
a constant if necessary. If the constant is biqger than 200 
octal, or if the value of the synbol is less than or equal 
to some minimum value (settable by the user, but normally 
the lowest location of the program) the entire address is 
typed as a constant. Tn absolute mode, addresses are always 
typed as constants. 

1.7 The Open Cell 

One other major ingredient of the DDT language is the 
open cell . Certain commands cause a cell to be "opened". 
This means that its contents are typed out. (except in enter 
mode, for which see the / command) , followed by a tab. Tf 
the user types an expression followed by a carriage return, 
it will be inserted into the cell in place of the current 
contents, and the cell will then be closed. The current 
location is given by the symbol w ." (dot) which always has 
as its value the address of the last cell opened, whether or 
not it is still open. 

Note : 

(1) Comma and star (for indexing and indirect address) 

may be used in expressions as they are used in the 
assembler; e.g. LDA* 0,2 has the value 27640000. 

(2) DDT will respond to any illegal input with the 

character ? followed by a tab (if a cell is open) 
or carriage return (otherwise) , after which it 
will behave as if nothing had been typed since the 
last tab or carriage return. The command ? also 
erases everything typed since the last tab or 
carriage return. 
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1.8 Heaory Allocation and DDT 



DDT aay cause the tiae-sharing system to assign memory 
for use either by DDT itself or by the user's program. 
DDT's memory is used to hold the syabol table, which starts 
in page and grows upward in aeaory. The syabol table 
contracts at the end of each load of a binary file and when 
syabols are killed; this contraction aay cause memeory to be 
released, 

DDT acquires prograa aeaory when it is required for 
loading a binary file or when a ;U (execute) coaaand is 
given and the value of ;F is such that a new block is needed 
to hold the instruction to be executed- For executing an 
instruction, DDT requires location ;?, ;F+1,;F*2. neaory is 
never grabbed for exaaination of a register; however, 
entering inforaation in cells which are in pages not in the 
aap will cause a block of neaory to be assigned for that 
page. Tf a cell is opened which is not assigned then DDT 
will type a ? and a tab, but the cell will remain open. 
Inforaation aay be filled into such a cell. 

If an atteapt to acguire or reference neaory leads to a 
trap, DDT types (H) and abandons whatever it is doing. This 
can happen if the machine size is exceeded, or if an attempt 
is made to change read-only memory. 
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2.0 PPT Connands 

Tn the following description of DDT connands, <S> will 
be used to denote an arbitrary synbol. <i?> or <W> will be 
used to denote an arbitrary expression which nay be typed by 
the nser: <E> will be used when the value of this 
expression is truncated to 14 bits before it is used by DDT, 
while <W> will denote a full 24 bit expression. <\> will be 
used to denote an optional 14 bit expression. Tf none is 
typed, the last expression printed out will usually be used; 
deviations froa this rule will be described under the 
individual connands. <P> will denote a file nane followed 
by a dot: DPT will type a tab whenever it expects a file 
nave. 

2.1 Cell O pe ning Connands 

<*>/ This opens the cell addressed by the value of 0>. 
DDT will give a tab, type an expression whose value is 
equal to the contents of the register, give another tab 
and await futher connands. The precise form of the 
expression typed is dependent on the setting of the 
word and address printout nodes. If the user types in 
an expression, DDT will insert its value into the cell. 
Typing another conaand closes the cell, unless it is a 
type value or synbol definition connand. Tf another / 
is given as the next connand with no preceding 
expression, the contents of the cell addressed by the 
expression typed by DDT are typed out. h further / 
repeats this process. Note, however, that the original 
cell opened reaains the open cell; any changes nade 
will go into that cell. % floating point nunber nay be 
inseted in the open cell and the following cell by 
typing a f V followed by a floating point nunber and 
then closing the cell. 

Carriage Return This connand does not necessarily have any 
effect. If the specified conditions are present, 
however, any of the following actions nay occur: 

(1) If there is an open cell, the cell is closed. 

(2) If DDT is in enter node, it leaves it. 

(3) If DDT is in patch node, the patch is 
terninated (for a fuller description of this 
effect, see the patch coaaand in Section 2.R1 
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<A>1 This coaaand has the save effect as /, except that 
the contents of the cell opened are always typed in 
symbolic fori!. 

<A>[ This coaaand has the saae effect as /, except that 
the contents of the cell opened are typed in constant 
for a. 

<!>$ This coaaand has the saae effect as /, except that 
the contents of the cell opened are typed as a signed 
integer. 

<E> W This coaaand acts like /, except that the cell 

contents are typed an ASCII. Unprintable characters, 

as in QED, are preceded by S, e.g. 14 1 (control-A) 
prints out as SA. 

<E>3 This coaaand has the saae effect as /, except that 
the contents of the cell opened are printed in 
foraatted fora. ^he foraat which is used is determined 
by the values of the two special symbols %n and %N. %* 
is a aask: of bits to be included in fields. A hit 
turned on in %* indicates the right-most bit of a 
field. The foraatting coanands will act as though the 
right-aost bit of %n is turned on whether it is or not. 
Por exaaple, if cell U00 contains 54356321B and 
*N=10101B and %H=77770777B, then we get 

4009 5**3S 3 21 

Successive fields in the open cell and following 
cells aay be changed by typing expressions for the n^w 
field values separated by ;, . 

<£>;• The contents of locations <E> and <E>*1 are treated 
as an SPS string pointer, and the string is printed. 
Cell <E> is opened. 

<E>*# The contents of locations <E> and <E>*1 are treated 
as a floating point nuaber which is printed. C*»ll <F> 
is opened. 

Line Feed This coaaand opens the ceil whose address is the 
current location plus one, i.e. the cell after the one 
just opened. The output of DOT on this command is 
carriage return, location (foraat controlled by the 
address printout aode) , /, tab, value of the contents, 
tab. 
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; ( = space) This is equivalent to line feed except that 
nothing is printed. Its naiit use is in entering 
programs or data, e.g. 

1000/ 1; 2; 3 (carriage return) 

is equivalent to 

1000/ 1 (carriage return) 
1001/ 2 (carriage return) 
1002/ 3 (carriage return) 

f This coaaand opens the cell whose address is the current 
location ainus one, i.e. the previous cell. The outDut 
is the sane as for the line feed coaaand. 

Exaaple: 

ABC/ LDA AIPHA (line feed) 

ABC+1/ STA BETA STA GAMHA (line feed) 

&BC+2/ LDB DELTA f 

ABC+1/ STA GAHHA 

{ This coaaand opens the cell whose address is t-he last 14 
bits of the value of the last expression typed. ^h» 
output is the sane as for line feed. 

/ This coaaand is the sane as /, except that the contents 
of the cell are not typed. DDT goes into enter mode, 
in which the contents of cells opened by line feed, ?, 
or ( are not typed. Most other coanands cause DOT to 
go out of enter node. In particular, carriage return 
has this effect. When a cell has been opened with /, 
DDT thinks that it has typed out the contents. The 
type value coaaands will, therefore, work on the 
contents of the cell. 

The type register in special aode characters [, "J, $, w , are 
also preserved by line feed, up arrow and (. 

;/ This coaaand supresses typeout of cell addresses during 
line feed, up arrow and ( chains. Carriage return 
cancels the coaaand. 

2.? Type Valu e Coaaands 
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« This command types the value of the last expression 
typed (;Q) in constant form. It aay appear in the form 
<¥>=, in which case the value of <M> is typed. 
Otherwise, the expression referred to is the one most 
recently typed, either by DDT or by the user. 

# This command types the value of ;0 as a signed integer. 
< This command types the value of ;Q in symbolic form. 

• This conaand types the value of ;Q typed as a word of 

text (see w conaand on previous page) . 

> This conaand types the value of ;Q in formatted forn. 
(see the <I>d conaand) . 



Example: 




LDA= 


7600000 


ID* 10= 


7600010 


LDA< 


LDA 


7600000* 


IDA 


-1= 


77777777 


-1# 


-1 


10221043* 


ABC 



;< This coaaand types ;Q as a character address, e.g. if 
the value of the syabol 1 is 1000, then 3002;* yields 
X;+2. Also, the current location is set to the word 
address of the character. 

;• This coaaand types the string pointed to by the 
contents of the current location and the following 
cell, consided as an SPS string pointer. 

<£>,<£>;• This coaaand types the string pointed to by the 
pair of expressions considered as an SPS string 
pointer. 

t# This coaaand types the contents of the current location 
and the following cell considered as a floating point 
number. 

<E> r <E>«# This coaaand types the pair of expressions 
considered as a floating point number. 
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2.3 Symbol Definition and Killing Com mands 

These conaands all define the symbol as global. 

<S>: This command defines the value of the symbol <S> to 
be the current location. 

<u> < <S>: This defines <S> to have the value of <W>. 

<W> < <S>;0 This defines <S> as an opcode with value <H>. 

;K (KILL) This command resets DDT f s symbol table to its 
initial state. DDT mill type back — OK and wait for a 
confirming dot. any other character will abort the 
command. 

<S>;K (KILL) This command removes only the symbol <s> from 
the symbol table. 

<S>£;F (KILL) This command removes all symbols local to 
the block named <S> from the symbol table , as well as 
removing the block name itself. This command will type 
back — OK and expect a confirming dot. 

%K This command will remove all undefined symbols from 
DDT«s symbol table. This implies that all references 
to undefined symbols will be lost. DDT will type — OK 
and expect a confirming dot. 

2. a Mode Changing Commands 

M This command is followed by a string of arbitrary 
characters terminated by control- D. If a cell is open, 
the string will be inserted into successive locations 
packed 3 characters per word; otherwise, characters 
beyond the third will be thrown away and the result 
treated as a constant. For example, if no register is 
open, "ABCDEcontrol-D= yields 102210*3. 

;D (DECIMAL) This command changes the current radix to 
decimal (see section 1.4). 

;0 (OCTAL) This command changes the current radix to 
octal. 

<E>;R (RADIX) This command sets the current radix to the 
value of the expression, which must be greater than or 
egual to 2. 

;f (CONSTANT) This command changes the word printout made 
to constant, i.e. makes / equivalentfto [. 
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;] (SYMBOLIC) This coaaand changes the nor* printout aode 
to syabolic, i.e. Bakes / eqivalent to "J. 

; n (ASCII) This coaaand Bakes / equivalent to w . 

;$ (SIGHED INTEGER) This coaaand Bakes / equivalent to $. 

;» (FOBHaTTED) This coaaand Bakes / equivalent to 3. 

;R (BELATIVE) This coaaand changes the address printout 
aode to relative (syabolic) . This deteraines the 
foraat for the output of addresses, both in svmbolic 
expressions and when generated by line feed and up 
arrow. 

;V (ABSOLUTE) This coaaand changes the address printout 
aode to absolute. 

;3 (3 CBABS/WORD) This sets the w and • coaaands to act on 
8 bit characters packed 3 per word. 

;ft (ft CHUBS/WORD) This coaaand sets n and • coaaands to 
operate on 6 bit characters packed 4 per word. 

2. 5 Breakpoint C oaaands 

There are four breakpoints in DDT. The first 
one is called the special breakpoint. The reaaining 3 
are called regular breakpoints. If a prograa atteapts 
to execute the instruction at an address at which a 
breakpoint is set, control returns to DDT which will 
print a break aessage and await further coaaands. The 
break occurs before execution of the instruction in the 
breakpoint location. ;L is set to the location at 
which the break occured. The break aessage will 
normally print the address of the break followed by the 
contents of any of the central registers which have 
changed since the last break. If it is the first break 
after a ;G then all registers will be typed. 
Furthernore, if a register has not been printed in the 
last ten break aessages, then it will be printed anyway 
in the for a ;A=<expression>, instead of the normal 
fora ;a«expression>. The contents of the break 
location will also be typed in the break aessage if the 
special syabol %1 is set to a non-negative value. The 
typing of the break address can be suppressed by 
setting the special syabol %P to a non- negative value. 
If one instruction is executed by the ;W or ;S 
coaaands, then the break aessage will include the 
address and new contents of any cell aodified as a 
result of executing that instruction. In addition to 
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these breakpoints there is the conditional breakpoint 
facility (see the section on conditional breaking). 

<I>! (SET SPECIAL BREAKPOINT) This command sets the special 
breakpoint to the value <E>. The previous value of the 
special breakpoint will of course be lost. 

! (CLEAR SPECIAL BREAKPOINT) This command clears the 
special breakpoint. 

<E>;! (SET REGULAR BREAKPOINT) This command sets a regular 
breakpoint to the value <E>. If all the regular 
breakpoints are already set then DOT will type back 
"POLL?. If a breakpoint already exists with that value 
then DDT will type a ?. 

<E>*! (CLEAR REGULAR BREAKPOINT) This command will clear a 
regular breakpoint that has the value <E>. If no such 
breakpoint exists, then DDT will type ?. 

*! (CLEAR ALL BREAKPOINTS) This command clears all G 
breakpoints. 

;! (list breakpoints) This command lists all breakpoints, 
the special breakpoint first. 

2.6 Program Exe cution Com mand s 

<A>,<A>;G (GO TO) This command allows transfer of 
control to the user program. The first argument, if 
given, specifies the starting address. The second 
argument, if given, specifies the number of breakpoints 
the program will pass through before the program halts. 
The first argument, if missing, is assumed to be the 
current location. The second argument, if missing, is 
assumed to be one. If there are any undefined symbols 
in DDT's symbol table, then DDT will type • — OK' and 
expect a confirming dot to be typed before it will 
allow transfer of control to the user program. This is 
true also of all the other progam execution commands. 

<A>,<A>;P (PROCEED) This command also causes transfer o^ 
control to the user program, but it is designed to 
restart a program after a breakpoint. It is identical 
to the ;G command, with the following exceptions. The 
;P command will not break on the first instruction 
executed if a breakpoint is set at that address, 
whereas the ;G command will break. The arguments o^ 
the ;p command are interpreted in the opposite order of 
the ;G command. All central registers will be printed 
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at. a break after a ;G conaand, while only the changed 
central registers are printed after the ;P command. 

<A>,<A>;V (ADVANCE) This coaaand is identical to the ;P 
coaaand except that a break aessage is printed at every 
breakpoint encountered daring execution of the program, 
whereas ;P will print a break aessaae only after the 
last breakpoint. 

<A>,<A>;H (NEXT) This conaand causes the number of 
instructions specified by the first argument to be 
exectuted starting at the address specified by the 
second argument. If the first argument is omitted then 
1 is assumed. If the second argument is omitted then 
;L is assumed. A break message is printed at the end 
of the execution. 

<A>,<A>;S (STEP) This command is identical to the ; w 
command except that a break message is printed after 
the execution of every instruction. 

<F>;0 (FXECOTE) This command causes the value of the 
expression to be executed as an instruction. Tf it is 
a branch, control goes to the location branched to. Tn 
all other cases control remains with DDT. A single 
carriage return is typed before executuion of the 
instruction. If the instrucition does not branch and 
does not skip, or returns to the following location, a 
$ and another carriage return are typed after its 
execution. If the instruction does skip, two dollar 
signs ($$) are typed followed by a carriage return. 

DDT may be put in pop trace aode by setting the special 
symbol %0 to a non-negative value. A negative value 
will cause DDT to leave pop trace mode. In pop trace 
node all programmed operators together with their 
associated subroutines will be treated like machine 
instructions for the ;W and ;S commands, i.e. the break 
will not occur until control returns to the location 
following the pop. Since DDT determines when it should 
break by counting POPs, BPSs, SBFNs, RRP.S, and SRRRs, 
it can be fooled by POPs which do sufficiently peculiar 
things. 

DDT can be put is subroutine trace node by setting the 
special symbol <fl to a non-negative value and removed 
from this mode by setting %U to a negative value. In 
subroutine trace mode BRHs and SBRrts together with 
their associatied subroutines will be treated as single 
instructions by the ;N and ;S commands. 
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Attempts to proceed through certain instructions having to 
do with forks will produce erroneous results, and 

breakpoints encountered when the program is running in 

a fork will not do the right thing. Attempts to 

proceed through unreasonable instructions will cause 

the error consent $» to be typed by DDT. Also, when 

control returns to DDT from a breakpoint or rubout, the 
interrupt mask for the program is cleared. 

2.6 Input/ouput C ommand s 

<A>;Y <F> DDT expects to find a binary program on the file 
<F>. If the program is absolute, it is read in. Tf it 
is relocatable, it is read in and relocated at the 
location specified by <A>. If the expression is 
omitted, relocatable loading commences at location ;F. 
;F is updated when the file is loaded. After reading 
is complete, the first location not used by the program 
is typed out. Any local symbols or opcode definitions 
on the binary file are ignored. 

<A>;T <F> This command is identical to ;Y except that it 
also reads local symbols and opcode definitions from 
the file and adds them to DDT*s symbol table. Any 
symbols on the file will be recognized by DD*^ 
thereafter. 

<A>tY <F> This command is identical to the ;Y command 
except that it will also read in opcode definitions and 
put them in DDT's symbol table, but it will still 
ignore local symbol definitions. 

The following two points should be noted in connection with 
;Y, %Y, or ;T commands. 

1) The use of an expression before ;T, or %1 or ;Y when 
the file is absolute (i.e. SAVE file) is an error. 

2) The block read in becomes the primary block. 

Several files can be loaded in a row with greater speed if a 
semi=colon is used for the file name terminator instead 
of a dot. Using a semi-colon causes the resorting of 
the DDT symbol table to be suppressed at the end of 
loading. 

;W <F> Causes all global symbols with their values to be 
written on the specified file, in a format which can be 
read back in with ;^. 
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;C <F> Causes all symbols to be written on the specified 
file. 

2.7 Search Commands 

<W>; W (HORD search) This command searches memeory 
between the limits ;1 and ;2 for cells whose contents 
Batch <w> when both are masked by the value of ;H. The 
locations and contents of all such cells are typed out. 

<W1>< <12>;i will perform the saae search, and in addition 
perforas the following replaceant: if is the address 
of a cell such that (Q) (and) ;M - W2, then the masked 
part of 81 will replace the masked part of (Q) . 

<W>;# (NOT word search) This is the same as ;W except 
that all cells which do not match <W> will be printed. 
This is useful, for example, in finding and printing 
all non-zero cells in a given part of memory. 

<E>;E (EFFECTIVE address search) This command searches 
meaory between the limits ;1 and ;2 for effective 
addresses equal to <E>. Indexing, if specified, is 
done with the value of ;X. Indirect address chains are 
followed to a depth of 64. The addresses and contents 
of all words found are typed out. When ;W or ;E is 
complete, '.• is left pointing to the last cell typed 
out. 

2. ft Patch Coaaands 

;) This command causes a patch to be inserted before the 
instruction in the open cell. A cell must be open for 
this command to be legal. DDT inserts in this location 
a branch to the current value of ;F. When the patch is 
done, ;? is updated. It then gives a carriage return 
and a ) and waits for the user to type in the patch. 
Legal input consists of a series of expressions whose 
values are inserted in successive locations in memory. 
Each of these expressions should be terminated by line 
feed or ; (space) , exactly as though the program were 
being typed in with the / commadnd instead of as a 
patch. The f command may be given in place of the line 
feed and has its usual meaning, except that the 
contents of the previous location are not typed. Two 
other commands are in patch mode, they are: 

(1) Colon, which may be used to define a symbol 
with value equal to the current location. 
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(2) Carriage return, which terminates the patch- 
When the patch is terminated, DDT inserts in 
the next available location the original 
contents of the location at which the patch 
was inseted. It then insets in the following 
two locations branch instructions to the 
first and second locations following the 
patch. This means that if the patched 
instruction is a skip instruction, the 
program will continue to operate correctly. 
Any other command given in patch mode may 
cause unpredictable errors. 

;{ This command is identical to ;) command except that it 
puts the instruction being patched before the new cofle 
inserted by the user instead of after. 

?.Q Miscellaneous Command s 

;2 (2**0) <E>,<E>;2 sets to zero all locations between 
the value of the first expression and that of the 
second. <E>«B> # <!>;Z sets to the value of the first 
expression all locations between the values of the 
second and third. ;Z alone releases all memory 
accessible to the user's program. DDT will type back 
— OK and wait for a confirming dot. Tf this memory is 
returned, due to later acces by DDT or a program, it 
will be cleared to zero. 

*& (LIST BLOCKS) This command causes all blocks known 
to DDT to be listed. Tf printing of symbols in that 
block has been suppressed then a ; 1 will be typefl 
following the block name. 

<Mock name>;] (SUPPRESS) ^nis command causes symbols in 
the given block to be ignored when DDT prints symbolic 
address. 

<block name>;[ This command reverses the action caused by 
the ; ] command. 

%? This command causes control to be returned to the fork 
which called DDT. 

*p (PPTNT HAP) The current program map is printed. 

<F>,<E>;P (SET NAP) The program map is set as indicated. 
This is equivalent to putting the expressions in A and 
n respectively and executing BPS &4. 
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%k This cob Band lists all ambiguous symbols in the DDT 
symbol table and lists the blocks that each ambiguous 
symbol is in. 

2. 10 Special Symbols 

DDT has built into it a number of special symbols. these 
symbols can have their values set with the following 
construct. <E>;& where ;A is a special symbol. if 
a special symbol is used in any other context then it 
is treated like any other symbol in DDT. Whenever DDT 
executes any command involving execution of 
instructions in the user*s program, it restores the 
values of all machine registers. If any of these 
values have been changed by the user, it is the changed 
value which will be restored. 

;» the value of this symbol is the contents of the & 
register 

B contents of the B register 

X contents of the X register 

L contents of the program counter 

n mask used by word search commands 

the value of this symbol +1 is the smallest address which 
DDT will ever attempt to print in symbolic form. 

;1 lower limit for searches using search commands 

;2 upper limit for searches 

;0 value of the last expression typed by DDT or the user. 

;F the value of this symbol is the address of the lowest 
location in core not used by the program. New literals 
and patches are inserted starting at this address. Tt 
is updated by patches, literal definitions, and load 
commands. 

^N The value of this symbol is the field descriptor for type 
out and loading of cells in formatted form. 

%n The value of this symbol is the mask for type out and 
loading of cells in formatted form. 
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*▼ The valve of this symbol is the opcode number which will 
next be used in automatic opcode definitions using the 
opcode linking feature of the DDT loader. (see the 
■anual on binary file format for the DDT loader) 

The remaining special symbols are used to control nodes in 
DDT. The specified action will occur if the symbol is 
set to a non-negative value. 

<B Turn on conditional breaking 

*T Print the instruction at ;L as part of a break messsage. 

%? Suppress printing of the value of the program counter as 
a part of the break message. 

%0 Suppress tracing of POP subroutines. 

to Suppress tracing of BFfl and SBRW subroutines. 

2.11 Panics 

DDT recognizes four kinds of panic conditions: 

(1) Illegal instruction panics from the user's 

program. 

(2) flenory allocation exceeded panics from the 

users' s program 

(3) Panics generated by pushing the rubout button. 

(4) Panics generated by the execution of BRS 10 in 

the user's program. 

For the first two of these conditions DDT prints out a 
message, the location of the instruction at which the 
panic occurred, and the contents of this location. The 
messages are as follows: 

(1) Illegal instruction panic T» 

(2) memory allocation panic f!>> 

(3) The other two types of panics cause DDT to 

type bell and carriage return. ;L and '.' 
will both be egual to the location at which 
the panic occurred. 
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Tf memory allocation exceed panic is caused by a transfer to 
an illegal location, the contents of the location 
causing the panic is not avialabe and DDT, therefore, 
types a ?. 

Two other paic conditions are possible in DDT. 

(1) If the rubout button is pushed twice with no 

intervening typing by the user, control 
returns to the calling fork, 

(2) If the rubout button is pushed while DDT is 

executing a command, execution and typeout 
are terminated and DDT types carriage return 
and bell and then awaits further commands. 

2. 12 Conditional Breaking 



Conditional breaking a feature which allows the user to run 
a program and hawe it break on the exact instruction 
where a specified condition becomes true. Conditional 
breaking is implemented by loading an interpreter at ;F 
when control is transfered to the user program. 
Therefore, if conditional breaking is used, 
approximately 200 cells following ;F will be clobbered. 
Conditional break mode is entered by setting the symbol 
%B to a non-negative number. A negative value of %R 
returns DDT to normal break mode. To use conditional 
breaking, put DDT in conditional break mode and specify 
a condition to break on using the %r, command. 
Thereafter, any transfer of control to the user program 
will cause conditional breaking to take effect. A user 
program will execute about 15 times slower in 
conditional break mode. 

To specify a break condition type *E. DDT will then type 
carriage return and expect the user to type a logical 
expression which obeys the following syntax. A 
conditional expression is terminated with a control-D. 
Control-a may be used to delete characters typed. When 
the value of this expression becomes true then the 
condition is satisfied and DDT will cause the user 
program to break. 

Syntax: 

<expr> < any number of <term> separated by 1 

<tem> < any number of primary separated by * 

<prim> < <operand1> <relational> <operand2> 
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<relational> < =/#/>/</<«/>= 



<operand1> < any nuaber of <operand2> separated by 
<operator> 

<operaor> < */-/*/blank 

<operand2> < [$] (<constant>/<syabol>/<special syabol> 

<special syabol> < ;a/;B/;I/;L/;1!/;0 

K constant nay be any legal DDT constant. 

K synbol nay be any defined symbol optionally preceded by a 
block naae and &• 

Semantics: 

Expressions are coaapiled left to right. The stregnth of 
binding of operators is as flollows: 

<operators>,<relationals>,*, !. 

! leans OP 

* leans AND 

9 leans n\SK i.e. extract second operand froa first operand. 

$ leans literal as opposed to contents of 

blank aeans address add e.g. b 3 is the contents of b+3 

♦ aeans add 

- aeans subtract 

;A,;B,;X are the contents of the central registers. 

;L is the prograa counter 

;E is the effective address of the current instruction. 

;0 is the 7-bit opcode field of the current instruction 
right justified. 

Examples: 

k 3~;F*;0=$H3»fl+3=*123 
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This expression will cause conditional breaking if the 
contents of A*3 is equal to the effective address of 
the current instruction at the sane tine that the 
opcode of the current instruction is tt3 or if the 
contents of B pins the contents of 3 equals 123. 



